home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / comm / mail / yapy.lha / YAPY / YAPY.doc < prev    next >
Encoding:
Text File  |  1997-07-11  |  6.1 KB  |  150 lines
  1.  
  2.                                    YAPY v1.3
  3.                        (Yet Another PGP-thingy for YAM)
  4.                             © 1997 Fredrik Rambris
  5.  
  6.                    Using SelectPGPKey © 1997 Jürgen Kempkes
  7.  
  8.  
  9.   LEGAL SHIT
  10.  ¯¯¯¯¯¯¯¯¯¯¯¯
  11. I take no responsibility what so ever in any circumstance. I nor anybody else
  12. gives you any guarantee at all. Use this program at your own risc. This program
  13. is distributed under the terms of MOO-WARE. You may spread it as long as it's
  14. unmodified and you Moo everytime you use YAPY =o].
  15.  
  16.  
  17.   INTRODUCTION
  18.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  19. This is a set of programs and scripts that integrates PGP with YAM 1.3.4. It
  20. allows you to sign, encrypt a message and add your public-key to the current
  21. letter. It ofcause also enables you to decode incoming messages and collect
  22. other's public-keys. It installs neatly on the 'Editor'-button in the
  23. 'Write letter'-window so that it's available at the writing stage. This will
  24. become obsolete when YAM 2.0 is released.
  25.  
  26.  
  27.   INSTALLATION
  28.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  29. The installation isn't that hard. This assumes that you've already installed
  30. PGP and YAM (both the latest versions) in your system, set the
  31. environment-variable PGP to the path of the PGP-binary (ex. Net:PGP) as
  32. described in the manual of PGP and finaly generated your key-pair.
  33.  
  34.  1. Copy the ReplacePGP and SelectPGPKey files to C:
  35.  2. Copy YAPY.rexx to YAM:Rexx
  36.  3. Copy EdMenu to YAM:
  37.  4. Open Configure-window in YAM and go to System (the right-most) and set the
  38.     editor to   C:EXECUTE YAM:EdMenu. But before you do that write
  39.     down or copy the contents of this field before changing it.
  40.  5. Save the settings.
  41.  6. Open a shell-window and set the environment-variable EDITOR to that you
  42.     just copied or wrote down. Ex.  SETENV EDITOR "C:Ed"
  43.  7. Make this permanent by copying it to ENVARC. Ex. COPY ENV:EDITOR ENVARC:
  44.  8. Edit the Set keyid "" line in YAM:EdMenu and set it to the
  45.     KeyID of your own key. To view your KeyID type PGP -kv and copy the number
  46.     after the key-length. Here's an example of the output. The portion to cut
  47.     is marked like this.
  48.  
  49.     ----[SHELL OUTPUT]-------------------------------------------------------
  50.  
  51.      --> pgp -kv
  52.     Pretty Good Privacy(tm) 2.6.3i - Public-key encryption for the masses.
  53.     (c) 1990-96 Philip Zimmermann, Phil's Pretty Good Software. 1996-01-15
  54.     International version - not for use in the USA. Does not use RSAREF.
  55.     Current time: 1997/06/22 17:48 GMT
  56.  
  57.     Key ring: 'Work:Comm/Internet/PGP/bin/pubring.pgp'
  58.     Type Bits/KeyID    Date       User ID
  59.     pub  1024/B2722B3D 1997/06/21 Fredrik Rambris <boost@bigfoot.com>
  60.     1 matching key found.
  61.  
  62.     -------------------------------------------------------------------------
  63.  
  64.     The line in YAM:EdMenu should in this example look like
  65.  
  66.         Set keyid "0xB2722B3D"
  67.  
  68.     As you can see is a 0x in front of the KeyID
  69.  
  70.  9. Add the following line to YAM:.config. 
  71.         RexxMenu1       = YAM:rexx/YAPY.rexx
  72.     You may replace RexxMenu1 with RexxMenu2, RexxMenu3 and so on. Pick one that
  73.     is not already taken.
  74.  
  75.   USAGE
  76.  ¯¯¯¯¯¯¯
  77. When you compose a message you may click on the Editor-button to invoke the
  78. YAPY-menu. Here you can select among the diferent actions that is
  79. offered. These are
  80.  
  81.   Edit - Edit the current message. Just like a normal Editor-button behaves.
  82.  
  83.   PGP Encrypt - Encrypt the current message. The recipient's user ID is then
  84.   asked for. After entering that the message is encrypted.
  85.  
  86.   PGP Sign - Sign the current message. You will be asked for your
  87.   passphrase and then a digital signature will be generated and appended to
  88.   your message.
  89.  
  90.   PGP Sign&Encrypt - Does the two above things in one go.
  91.  
  92.   Insert your Pub-key - This will extract your public-key (or the one
  93.   specified in keyid) and append it to the current message. This is
  94.   good when you want to give someone your public-key so that they can send
  95.   encrypted letter to you.
  96.  
  97.   Nothing - Will just quit the requester.
  98.  
  99.  
  100. Also when you recieve a pgp-message (signed, encrypted or just a key) you
  101. simply select it (in the main window by single-clicking it) and choose
  102. YAPY.rexx in the ARexx menu. If it is a public-key it will be added to your
  103. public-keyring. If it is a encrypted message it will get decrypted. Finaly if
  104. it is signed it will be checked and if authentic it will remove the PGP
  105. signature.
  106.  
  107.  
  108.   HISTORY
  109.  ¯¯¯¯¯¯¯¯¯
  110.  
  111. 1.3 (11.7.97) Jees! YAPY sure got response in the Amiga-world. So this time
  112.               I've worked day and night to get this version ready... NOT! :o].
  113.               Anyway. Included SelectPGPKey by Jürgen Kempkes which I got just
  114.               two hours ago. Now you're able to select multiple recipents.
  115.  
  116. 1.2 (4.7.97)  Never made it to Aminet. Fixed the bug with 'pub' isn't always
  117.               'pub'.
  118.  
  119. 1.1 (30.6.97) Second release on Aminet. (I thought I'd never update it =) )
  120.               Fixed a bug in EdMenu causing KeyID parsing to fail.
  121.               Also included SelectKey by Michael Praschl with is permission.
  122.               Now you're able to select a key by clicking in a MUI-gui.
  123.  
  124. 1.0 (23.6.97) Initial release on Aminet.
  125.  
  126.   FUTURE
  127.  ¯¯¯¯¯¯¯¯
  128. This thingy may not be updated in the future. I just thought that there wasn't
  129. any good integrations of PGP with YAM. They all had their drawbacks. The
  130. drawback of YAPY is probably the installation-part (no installer-script).
  131. Anyway... back to the topic. As Marcel Beck will release YAM 2.0 in a month or
  132. so with built in and better integration of PGP with YAM along with a load of
  133. other neat news (not NEWS =) ) this bulk of bits and bytes will become obsolete
  134. when so. 
  135.  
  136.  
  137.   AUTHOR
  138.  ¯¯¯¯¯¯¯¯
  139.  
  140. This program and documentation is written by Fredrik Rambris. If you want to
  141. get in contact with me try these things:
  142.  
  143.     email:    boost@bigfoot.com  (prefered)
  144.       irc:    BOOST on EfNet (/who *|boost@*.algonet.se)
  145.  homepage:    http://hem1.passagen.se/frambris
  146. snailmail:    Fredrik Rambris
  147.             Blåeldsv. 14a
  148.             S-231 75  BEDDINGESTRAND
  149.                SWEDEN
  150.